Add a banner on the old documentation docs.
PATCH v16 1/1 Add a banner on the old documentation docs.
Script to add banners to the old docs and outdated dunfell docs
--- scripts/docs_add_banner.py | 84 ++++++++++++++++++++++++++++++++++++++ scripts/run-docs-build | 2 + 2 files changed, 86 insertions(+) create mode 100755 scripts/docs_add_banner.py
scripts/docs_add_banner.py new file +84 -0
@@ -0,0 +1,84 @@ +#!/usr/bin/env python3 +# +# SPDX-License-Identifier: GPL-2.0-only +# +#Signed-off-by: Abongwa Bonalais Amahnui <[email protected]> +# +# +# Script to add banners to the old docs and outdated dunfell docs +# +# + + +import os + + + + + +html_content_dunfell = ''' +<div id="outdated-warning">This document is outdated, you should select the <a href="https://docs.yoctoproject.org/dunfell">latest release version</a> in this series.</div> +<div xml:lang="en" class="body" lang="en"> +''' +html_content = ''' +<div id="outdated-warning">This version of the project is now considered obsolete, please select and use a <a href="https://docs.yoctoproject.org">more recent version</a>.</div> +<div xml:lang="en" class="body" lang="en"> +''' + +# the class body and the last_div are used to make sure any .body property existing in any css file is not overwritten +last_div = ''' +</div> + +''' + +css_replacement_content = ''' + + font-family: Verdana, Sans, sans-serif; + + width: 100%; + margin: 0; + padding: 0; + color: #333; + overflow-x: hidden; + } + +.body{ +margin: 0 auto; +min-width: 640px; +padding: 0 5em 5em 5em; +} +#outdated-warning{ +text-align: center; +background-color: rgb(255, 186, 186); +color: rgb(106, 14, 14); +padding: 0.5em 0; +width: 100%; +position: fixed; +top: 0; + + +''' + + +def add_banner_old_docs(dir): + for root, dirs, filenames in os.walk(dir): + + if root.startswith('./3.1'): + html_replacement = html_content_dunfell + else: + html_replacement = html_content + + for filename in filenames: + if filename.endswith('.html'): + with open(os.path.join(root, filename), 'r', encoding="ISO-8859-1") as f: + current_content = f.read() + with open(os.path.join(root, filename), 'w', encoding="ISO-8859-1") as f: + f.write(current_content.replace('<body>', '<body>' + html_replacement)) + f.write(current_content.replace('</body>', last_div + '</body>')) + if filename.endswith('.css'): + with open(os.path.join(root, filename), 'r', encoding="ISO-8859-1") as f: + css_content = f.read() + with open(os.path.join(root, filename), 'w', encoding="ISO-8859-1") as f: + f.write(css_content.replace(css_content[css_content.find('body {'):css_content.find('}'[0])], 'body {' + css_replacement_content )) + +add_banner_old_docs('.')
scripts/run-docs-build +2 -0
@@ -37,6 +37,8 @@ cd $outputdir echo Extracing old content from archive tar -xJf $docbookarchive +$scriptdir/docs_add_banner.py + cd $bbdocs mkdir $outputdir/bitbake
Signature · 1 line
2.25.1
Hi Amahnui,
Quoted 3 lines · Abongwa Amahnui Bonalais
Script to add banners to the old docs and outdated dunfell docs
Signed-off-by Abongwa Bonalais Amahnui <[email protected]>
Thanks for the patch and your patience, this is an important piece that was missing, so thank you for taking the time to do it.
Now, other reviewers can still say that there are other changes to do.
If after a few weeks you still don't see your patch being merged in https://git.yoctoproject.org/yocto-autobuilder-helper, you can send a mail here telling us to have a look at it again, but that is usually unnecessary since merging is happening rather fast in this open-source project.
Cheers,
Quentin
Quoted 14 lines · Quentin Schulz
Quoted 2 lines · Abongwa Amahnui Bonalais
Script to add banners to the old docs and outdated dunfell docs
Signed-off-by Abongwa Bonalais Amahnui <[email protected]>Reviewed-by Quentin Schulz <[email protected]>Thanks for the patch and your patience, this is an important piece that was missing, so thank you for taking the time to do it.
Now, other reviewers can still say that there are other changes to do.
Quoted 7 lines
If after a few weeks you still don't see your patch being merged in https://git.yoctoproject.org/yocto-autobuilder-helper
, you can send a mail here telling us to have a look at it again, but that
is usually unnecessary since merging is happening rather fast in this
open-source project.Cheers,
Quentin
Hi Quentin,
Thank you very much too, I really appreciate your help through out this proccess, I will do as you've said.
Quoted 82 lines · Abongwa Amahnui Bonalais
Script to add banners to the old docs and outdated dunfell docs
Signed-off-by Abongwa Bonalais Amahnui <[email protected]>--- scripts/docs_add_banner.py | 84 ++++++++++++++++++++++++++++++++++++++ scripts/run-docs-build | 2 + 2 files changed, 86 insertions(+) create mode 100755 scripts/docs_add_banner.pyscripts/docs_add_banner.py new file +67
-0@@ -0,0 +1,84 @@ +#!/usr/bin/env python3 +# +# SPDX-License-Identifier: GPL-2.0-only +# +#Signed-off-by: Abongwa Bonalais Amahnui <[email protected]> +# +# +# Script to add banners to the old docs and outdated dunfell docs +# +# + + +import os + + + + + +html_content_dunfell = ''' +<div id="outdated-warning">This document is outdated, you should select the <a href="https://docs.yoctoproject.org/dunfell">latest release version</a> in this series.</div> +<div xml:lang="en" class="body" lang="en"> +''' +html_content = ''' +<div id="outdated-warning">This version of the project is now considered obsolete, please select and use a <a href="https://docs.yoctoproject.org">more recent version</a>.</div> +<div xml:lang="en" class="body" lang="en"> +''' + +# the class body and the last_div are used to make sure any .body property existing in any css file is not overwritten +last_div = ''' +</div> + +''' + +css_replacement_content = ''' + + font-family: Verdana, Sans, sans-serif; + + width: 100%; + margin: 0; + padding: 0; + color: #333; + overflow-x: hidden; + } + +.body{ +margin: 0 auto; +min-width: 640px; +padding: 0 5em 5em 5em; +} +#outdated-warning{ +text-align: center; +background-color: rgb(255, 186, 186); +color: rgb(106, 14, 14); +padding: 0.5em 0; +width: 100%; +position: fixed; +top: 0; + + +''' + + +def add_banner_old_docs(dir): + for root, dirs, filenames in os.walk(dir): + + if root.startswith('./3.1'): + html_replacement = html_content_dunfell
scripts/docs_add_banner.py line 77
Quoted 10 lines
scripts/docs_add_banner.py new file +10
-0+ else: + html_replacement = html_content + + for filename in filenames: + if filename.endswith('.html'): + with open(os.path.join(root, filename), 'r', encoding="ISO-8859-1") as f: + current_content = f.read() + with open(os.path.join(root, filename), 'w', encoding="ISO-8859-1") as f: + f.write(current_content.replace('<body>', '<body>' + html_replacement)) + f.write(current_content.replace('</body>', last_div + '</body>'))
This is really close but still not quite right. You're adding in two copies of current_content here. It needs to be:
f.write(current_content.replace('<body>', '<body>' + html_replacement).replace('</body>', last_div + '</body>'))
so that only one copy of current_content is written.
Cheers,
Richard